_v Specifies a pointer to an array of two, three, or four elements,
specifying x, y, z, and w coordinates, respectively.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The GL maintains a 3D position in window coordinates. This position,
called the raster position, is used to position pixel and bitmap write
operations. It is maintained with subpixel accuracy. See ffffggggllllBBBBiiiittttmmmmaaaapppp,
ffffggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, and ffffggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss.
The current raster position consists of three window coordinates (x, y,
z), a clip coordinate value (w), an eye coordinate distance, a valid bit,
and associated color data and texture coordinates. The w coordinate is a
clip coordinate, because w is not projected to window coordinates.
ffffggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444 specifies object coordinates x, y, z, and w explicitly.
ffffggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333 specifies object coordinate x, y, and z explicitly, while w
is implicitly set to 1. ffffggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222 uses the argument values for x and
y while implicitly setting z and w to 0 and 1.
The object coordinates presented by ffffggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss are treated just like
those of a ffffggggllllVVVVeeeerrrrtttteeeexxxx command: They are transformed by the current
modelview and projection matrices and passed to the clipping stage. If
the vertex is not culled, then it is projected and scaled to window
coordinates, which become the new current raster position, and the
GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN____VVVVAAAALLLLIIIIDDDD flag is set. If the vertex _i_s culled,
then the valid bit is cleared and the current raster position and
associated color and texture coordinates are undefined.
The current raster position also includes some associated color data and
texture coordinates. If lighting is enabled, then
GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____CCCCOOOOLLLLOOOORRRR (in RGBA mode) or GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____IIIINNNNDDDDEEEEXXXX (in
color index mode) is set to the color produced by the lighting
calculation (see ffffggggllllLLLLiiiigggghhhhtttt, ffffggggllllLLLLiiiigggghhhhttttMMMMooooddddeeeellll, and
ffffggggllllSSSShhhhaaaaddddeeeeMMMMooooddddeeeellll). If lighting is disabled, current color (in RGBA mode,
state variable GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____CCCCOOOOLLLLOOOORRRR) or color index (in color index mode,
state variable GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX) is used to update the current raster
color.
Likewise, GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDDSSSS is updated as a function of
GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDDSSSS, based on the texture matrix and the texture
generation functions (see ffffggggllllTTTTeeeexxxxGGGGeeeennnn). Finally, the distance from the
origin of the eye coordinate system to the vertex as transformed by only
the modelview matrix replaces GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____DDDDIIIISSSSTTTTAAAANNNNCCCCEEEE.
Initially, the current raster position is (0, 0, 0, 1), the current
raster distance is 0, the valid bit is set, the associated RGBA color is
(1, 1, 1, 1), the associated color index is 1, and the associated texture
coordinates are (0, 0, 0, 1). In RGBA mode, GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____IIIINNNNDDDDEEEEXXXX is
always 1; in color index mode, the current raster RGBA color always
maintains its initial value.
NNNNOOOOTTTTEEEESSSS
The raster position is modified both by ffffggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss and by ffffggggllllBBBBiiiittttmmmmaaaapppp.
When the raster position coordinates are invalid, drawing commands that
are based on the raster position are ignored (that is, they do not result
in changes to GL state).
Calling ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss, or ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss may leave the current
color or index indeterminate. If ffffggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss is executed while the
current color or index is indeterminate, the current raster color or
current raster index remains indeterminate.
To set a valid raster position outside the viewport, first set a valid
raster position, then call ffffggggllllBBBBiiiittttmmmmaaaapppp with NULL as the _b_i_t_m_a_p parameter.
EEEERRRRRRRROOOORRRRSSSS
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss is executed between the
execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd.
ffffggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN
ffffggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN____VVVVAAAALLLLIIIIDDDD
ffffggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____DDDDIIIISSSSTTTTAAAANNNNCCCCEEEE
ffffggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____CCCCOOOOLLLLOOOORRRR
ffffggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____IIIINNNNDDDDEEEEXXXX
ffffggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDDSSSS
